Skip to main content

Calculadora Generica

POST /apicbgenerica​

Descripción: Endpoint utilizado para ejecutar cálculos de títulos genéricos que no están en la base de datos del sistema. Permite crear un título temporal con sus características y ejecutar cálculos sobre él.

Parámetros:

titulo_generico:

  • nemotecnico - Nemotécnico del título genérico
  • codisin - Código ISIN del título
  • base_liquidacion - Base de liquidación (ej: "Actual/Actual", "30/360")
  • formula_descuento - Fórmula de descuento a utilizar
  • periodicidad - Periodicidad de pago (ej: "Semestral", "Trimestral")
  • tasa_cupon - Tasa de cupón anual del título
  • fecha_emision - Fecha de emisión, formato YYYY-MM-DD
  • fecha_vencimiento - Fecha de vencimiento, formato YYYY-MM-DD
  • valor_nominal_unitario - Valor nominal unitario del título
  • moneda - Moneda del título (ej: "DOP", "USD")
  • emisor - Nombre del emisor
  • tipo_tasa - Tipo de tasa (ej: "Tasa Fija", "Tasa Variable")
  • nombre_instrumento - Nombre del instrumento

calculo_input:

  • tipo_insumo - r (rendimiento), p (precio) o t (transado)
  • tipo_monto - n (nominal) o t (transado)
  • insumo - Valor del insumo
  • monto - Valor del monto
  • fecha_liquidacion - Fecha de liquidación, formato YYYY-MM-DD

config:

  • with_flujos - true/false para incluir los flujos
  • carry_efectivo - true/false para incluir carry efectivo
  • round - Número de decimales para redondeo

Consulta:

{
  "auth": {
    "usuario": "colocar_usuario",
    "password": "colocar_password"
  },
  "titulo_generico": {
    "nemotecnico": "CUSTOM01",
    "codisin": "DO1234567890",
    "base_liquidacion": "Actual/Actual",
    "formula_descuento": "8-6-2-365-2-366",
    "periodicidad": "Semestral",
    "tasa_cupon": 12.5,
    "fecha_emision": "2023-01-15",
    "fecha_vencimiento": "2033-01-15",
    "valor_nominal_unitario": 100000,
    "moneda": "DOP",
    "emisor": "Emisor Genérico",
    "tipo_tasa": "Tasa Fija",
    "nombre_instrumento": "Bono Genérico"
  },
  "calculo_input": {
    "tipo_insumo": "r",
    "tipo_monto": "n",
    "insumo": 11.5,
    "monto": 500000,
    "fecha_liquidacion": "2024-06-15"
  },
  "data_calculo": null,
  "config": {
    "with_flujos": true,
    "carry_efectivo": false,
    "round": 10
  }
}

Respuesta:

{
  "titulo_calculo": {
    "nemotecnico": "CUSTOM01",
    "codisin": "DO1234567890",
    "emisor": "Emisor Genérico",
    "moneda": "DOP",
    "nombre_instrumento": "Bono Genérico",
    "nombre_periodo": "Semestral",
    "tipo_tasa": "Tasa Fija",
    "tipo_amortizacion_capital": "No Amortizable",
    "base_liquidacion": "Actual/Actual",
    "formula_calculo": "8-6-2-365-2-366",
    "monto_nominal": 500000,
    "cantidad_titulos": 5,
    "valor_nominal_unitario": 100000,
    "precio_limpio": 105.23,
    "precio_sucio": 108.45,
    "rendimiento": 11.5,
    "cupon": 12.5,
    "macaulay_duration": 5.67,
    "modified_duration": 5.34,
    "convexidad": 35.21
  },
  "flujos_titulo": [
    {
      "fecha_flujo": 1705276800,
      "fecha_flujo_str": "2024-01-15",
      "monto_interes": 31250.0,
      "monto_flujo": 31250.0
    }
  ]
}